home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / greed.zip / INSTALL.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-06-03  |  16KB  |  428 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4. (c) Copyright Janosch R. Kowalczyk, 1996.
  5.  
  6. myNstall is the universal small PM installation program for OS/2 from Janosch 
  7. R. Kowalczyk. 
  8.  
  9. All rights reserved. 
  10.  
  11. This program is Freeware. You can use this program for your own private 
  12. purposes, but you cannot change any of the contents with following exceptions: 
  13.  
  14.    1. Contents of the file INSTALL.DAT. 
  15.    2. You can use your own help file, but you MUST enclose following chapters 
  16.       from the existing INSTALL.HLP: 
  17.           Author 
  18.           Author's thanks 
  19.           Copyright (this chapter) 
  20.           Disclaimer 
  21.           Introduction 
  22.  
  23.  Please send all bug reports and improvement suggestions to the author. 
  24.  
  25.  
  26. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  27.  
  28. The myNstall ([maj:]Nstall) is the universal small installation PM-program. 
  29.  
  30. It uses control words to arrange the installation process and gives you the 
  31. interface to your own Rexx routines, so that you can design the installation 
  32. process with more flexibility as you are now able to. Of course you can omit 
  33. all these controls and work with the default values as delivered. 
  34.  
  35. If you want to work without the control words, you can use this routine as is. 
  36. It copies almost all files (with exception of hidden and system files) from the 
  37. home directory into the selected destination directory. 
  38.  
  39. myNstall revision history 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 2.1. myNstall revision history ΓòÉΓòÉΓòÉ
  43.  
  44. These are the new features that were added for the version 1.01 Beta of 
  45. myNstall. 
  46.  
  47. Following keywords for the control file INSTALL.DAT were added: 
  48.  
  49.    1. WPS_ONLY_IF_EXIST= to hide/show the check box "Create WPS object only". 
  50.    2. WELCOME_BUTTON=OKCANCEL | OK to show in the Welcome message of your 
  51.       installation the buttons OK and Cancel or OK only. 
  52.    3. WELCOME_TITLE= to set the Title for this message. 
  53.    4. WELCOME= to set the message text. You can use this keyword multiple 
  54.       times. 
  55.    5. START_REXX_BY_OPEN_WINDOW= to start your own Rexx routine at the start of 
  56.       the installation process (Exit 1). 
  57.    6. START_REXX_BY_START_INSTALL= to call your own Rexx routine after you 
  58.       pressed the Install-Button but before the installation has started (Exit 
  59.       2). 
  60.    7. START_REXX_BY_SUCCESSFUL= to start your own Rexx routine after the 
  61.       successful installation (Exit 3). 
  62.    8. START_REXX_IF_FAILURE= to start your own Rexx routine if the installation 
  63.       has failed (Exit 4). 
  64.    9. START_REXX_BY_CLOSE_WINDOW= to start your own Rexx routine before you 
  65.       exit the installation process (Exit 5). 
  66.   10. DELETE_FILE= to delete a file from the destination directory before you 
  67.       start the installation process. You can use this keyword multiple times. 
  68.       It is useful for the update installation. 
  69.   11. REMOVE_DIR= to delete a subdirectory from the destination directory 
  70.       before you start the installation process. You can use this keyword 
  71.       multiple times. It is useful for the update installation. 
  72.  
  73.  These are the new features that were added for the version 1.02 Beta of 
  74.  myNstall. 
  75.  
  76.    1. DELETE_FILE_AFTER_INSTALLATION= to delete a file from the destination 
  77.       directory after successfully installing your product. 
  78.    2. REMOVE_DIR_AFTER_INSTALLATION= to delete a subdirectory from the 
  79.       destination directory  after successful installation. 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 3. System requirements ΓòÉΓòÉΓòÉ
  83.  
  84. myNstall requires approximately 200 kB (additional INSTALL.DAT) of disk space. 
  85. To use myNstall to install products, the following must be on the computer: 
  86.  
  87.      OS/2 version 2.x or higher, 
  88.      Rexx support. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 4. How to install? ΓòÉΓòÉΓòÉ
  92.  
  93. To install a product: 
  94.  
  95.      Use the program INSTALL.EXE to start installation - an installation 
  96.       window will be displayed. 
  97.      Select the drive letter in the Box named Drive. 
  98.      Select the directory in the Box named Directory: 
  99.            Single click with the mouse button 1 selects the directory, 
  100.            Double click with the mouse button 1 opens the subdirectory list. 
  101.      The path to the last selected directory is showing in the entry field 
  102.       named Path. 
  103.      If you wish to install the product into a new directory, you should write 
  104.       its name into the entry field named Path. 
  105.      Select the push button Install to start the installation. 
  106.      If the destination directory not yet exists, you will be prompted for 
  107.       confirmation. 
  108.      Select Yes to install or No to cancel the installation. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 5. How does the myNstaller work? ΓòÉΓòÉΓòÉ
  112.  
  113. To use the myNstall copy following files into your products source 
  114. (installation) directory: 
  115.  
  116.      INSTALL.EXE 
  117.      INSTALL.HLP 
  118.      [INSTALL.DAT] 
  119.  
  120.  INSTALL.DAT is the control file with the keywords to control your installation 
  121.  process. You don't need this file, if you don't want to use its features. 
  122.  
  123.  The myNstall unpacks almost all files (with exception of files with attributes 
  124.  H (hidden) and S (system) from the home (source) directory into the current 
  125.  destination directory. 
  126.  
  127.  See OS/2 UNPACK command for more info. 
  128.  
  129.  Note:  If the current destination directory does not exist, it will be 
  130.  created. You will be prompted for the confirmation. 
  131.  
  132.  The description of the WPS objects is situated in the file INSTALL.DAT. The 
  133.  description records must be enclosed in parenthesis ( ). If you want to create 
  134.  a folder for other objects, it must be placed at the beginning of the listing. 
  135.  For the syntax see the parameter list of the REXX function SysCreateObject. 
  136.  
  137.  Note:  You can only use one (1) line for one (1) description record. i.e.: 
  138.  
  139.           /*------(start WPS objects)-----*/
  140.           ("WPFolder", title, location, associations, "r")
  141.           ("WPProgram", title, location, associations, "r")
  142.              other descriptions record
  143.              other descriptions record
  144.           /*------(end WPS objects)-----*/
  145.  
  146.  See chapter Control words (keywords) in this file for more information. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 6. Control words summary ΓòÉΓòÉΓòÉ
  150.  
  151. The following are keywords to control the installation process: 
  152.  
  153.    1. DESTINATION=destination_directory_path 
  154.    2. WPS_ONLY_IF_EXIST=file_name 
  155.    3. WELCOME=welcome_message 
  156.    4. WELCOME_TITLE=message_title 
  157.    5. WELCOME_BUTTON={OK | OKCANCEL} 
  158.    6. START_REXX_BY_OPEN_WINDOW=rexxcall 
  159.    7. START_REXX_BY_START_INSTALL=rexxcall 
  160.    8. START_REXX_BY_SUCCESSFUL=rexxcall 
  161.    9. START_REXX_BY_FAILURE=rexxcall 
  162.   10. START_REXX_BY_CLOSE_WINDOW=rexxcall 
  163.   11. DEST_PATH (used by SysCreateObject and your own Rexx) 
  164.   12. HOMEDIR (to be used by your own Rexx) 
  165.   13. DELETE_FILE 
  166.   14. REMOVE_DIR 
  167.   15. DELETE_FILE_AFTER_INSTALLATION 
  168.   16. REMOVE_DIR_AFTER_INSTALLATION 
  169.  
  170.  See chapter Control words (keywords) for more details. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 7. Control words (keywords) ΓòÉΓòÉΓòÉ
  174.  
  175. Note:  You can write the keywords into the file INSTALL.DAT in any order! 
  176.  
  177. In the follwing chapters are described keywords which you can use in the 
  178. control file INSTALL.DAT. 
  179.  
  180. Remember:  you can omit all these controls and work with default values only. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 7.1. Destination path ΓòÉΓòÉΓòÉ
  184.  
  185. DESTINATION=destination_directory_path 
  186.  
  187. This keyword identifies the record from file INSTALL.DAT which sets the name of 
  188. the standard destination directory. 
  189.  
  190. If you omit this name, the root directory of the drive C: will be used. 
  191.  
  192. You should omit the leading and ending backslashes and the drive character. 
  193.  
  194. Default value:   root directory of the drive C: (drive C: is always the default 
  195. drive. Everybody has drive C: - don't they?). 
  196.  
  197. Example:  DESTINATION=TOOLS\INSTALL 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 7.2. Create WPS object only ΓòÉΓòÉΓòÉ
  201.  
  202. WPS_ONLY_IF_EXIST=file_name 
  203.  
  204. The Installer is able to recreate the damaged WPS-Objects for your 
  205. installation. It does this if the Check Box Create WPS objects only is 
  206. selected. But it is not necessary to show this box if the user is doing his 
  207. first installation. You can hide this Check Box for the installation window if 
  208. you